API product inventory retrieval

Sellvio allows store owners to display personalized product inventories on various listing pages, such as Facebook Shop, Olcsobbat.hu, Argep.hu, etc., through API access URLs.

The product API administration screen is available from the admin sidebar under the Webshop → API menu.

For each service listed on the API administration screen, it is required that the store owners have an account with the respective service. Once an account is created with a specific service, the store owner can copy and paste the appropriate API link from Sellvio into their profile page on the service provider's site.

Product listing services require store owners to configure their accounts in a specific way. For more details, please refer to the documentation on the service provider's website to understand how to integrate the API links into their system.

The listed products must also be provided through their specific structure. Sellvio manages the product structure in the background, so store owners do not need to handle this.

General Tab

The settings on the General tab are identical for all services. Therefore, this documentation covers the details for one service, as the configuration process is the same for all services.

1. Each product listing service is linked to a specific country. Administrators can filter the list by a specific country using the dropdown menu at the top of the page.
2. The country where the service is available is shown in the top-right corner of the service.
3. Service Name: The name of the product listing service.
4. Categories: The category selection input allows store owners to specify which webshop categories they wish to display products from on the product listing service page. There is no limit on the number of categories that can be selected.
5. Brands: The manufacturer selection input allows store owners to specify which manufacturers they want to showcase products from on the product listing service page. There is no limit on how many manufacturers can be selected.
6. URL: This field displays the automatically generated URL. Any changes to the settings above will automatically update the generated URL. The language code (/en, /hu, /sr) in the generated URL is determined by the current language of the admin interface. This determines the language in which the products will appear on the product listing website.
7. Format: The format dropdown menu allows clients to select the format in which the products will be served through the URL.
8. Once all settings are configured, the API URL can easily be copied to the clipboard by clicking the Copy button at the end of the URL field.

IMPORTANT: Products that are not visible or unavailable will not appear in the product list shared through the API URL.

User API Tokens Tab

The User API Tokens feature allows the creation of an API endpoint that contains a unique list of products for a specific registered user.

By selecting webshop categories and manufacturers, administrators can narrow down which products from the store should be included in the API endpoint. If no category or manufacturer is selected, the endpoint will include all available products from the webshop.

Since the endpoint is created for a specific user, the products served via the API URL include system-level user discounts, which can be set individually for each registered user on the Users → Users page, under the Discounts tab. For a quick refresher on user-specific discounts, please refer to this article.

1. Categories: The category selection input allows store owners to specify which webshop categories the products should come from. There is no limit on how many categories can be selected.
2. Manufacturers: The manufacturer selection input allows store owners to specify which manufacturers’ products should be included. There is no limit on how many manufacturers can be selected.
3. User: The registered user for whom the API endpoint should be created. This field allows searching by user name or email address.

By clicking the Save button, the selected user’s API endpoint will be created with the provided configuration.

All previously created API endpoints are listed on the User API Tokens tab, following the Create User API Token section.

1. User Name and Email: The registered user's name and email address, along with the number of endpoints the client has used.
2. The section containing the list of endpoints owned by the user can be expanded or collapsed using the arrow button in the top-right corner of the section. Administrators can choose the endpoint format and, using the format dropdown menu, copy the created endpoint to the clipboard by clicking the Copy button.
3. If an API endpoint is no longer needed, it can be easily deleted by clicking the red trash can icon at the end of the API URL entry.
4. Clicking the blue Settings button at the end of the API URL entry will display the configuration with which the endpoint was created.

IMPORTANT: Existing API URL settings can only be viewed, not edited.